home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / Read-Me-ori < prev    next >
Text File  |  1997-04-24  |  17KB  |  358 lines
  1. Installation notes for OzTeX 3.0, February 1997
  2. ===============================================
  3.  
  4. Andrew Trevorrow
  5. akt@kagi.com
  6. http://www.kagi.com/authors/akt/
  7.  
  8.  
  9. CONTENTS:
  10. Introduction
  11. System and memory requirements
  12. How to install OzTeX
  13. How to print the OzTeX User Guide
  14. Important changes
  15. Choosing an editor
  16. A minimal OzTeX system
  17.  
  18.  
  19. Introduction
  20. ------------
  21.  
  22. OzTeX is a Macintosh implementation of Donald Knuth's TeX typesetting system.
  23. This file explains how to install OzTeX and print out the OzTeX User Guide.
  24. OzTeX is shareware, so if you like it and decide to keep it then please pay
  25. the shareware fee; see the "Shareware Fee" item in OzTeX's Help menu for
  26. payment details.
  27.  
  28. OzTeX is normally distributed as a set of BinHex files:
  29.  
  30. oztex.hqx       - the OzTeX application (68000 and PowerPC code).
  31. ozmf.hqx        - the OzMF application (ditto).
  32. ozmp.hqx        - the OzMP application (ditto).
  33. correct.hqx     - the Correct file (to check the installation).
  34. configs.hqx     - the Configs folder.
  35. help.hqx        - the Help-files folder.
  36. texdocs.hqx     - the TeX-docs folder (contains useful test files).
  37. latexdocs.hqx   - the LaTeX-docs folder (contains the OzTeX User Guide).
  38. inputs.hqx      - the TeX-inputs folder.
  39. formats.hqx     - the TeX-formats folder.
  40. fonts.hqx     * - the TeX-fonts folder.
  41. vf.hqx        * - the VF-files folder.
  42. pk.hqx        * - the PK-files folder.
  43. ps.hqx          - the PS-files folder.
  44. dvips.hqx       - the DVIPS folder.
  45. metafont.hqx    - the Metafont folder (used by OzMF).
  46. metapost.hqx    - the MetaPost folder (used by OzMP).
  47. ams.hqx         - the AMS folder (with AMS-TeX, AMS-LaTeX and AMSFonts).
  48. alphalite.hqx   - AlphaLite 6.5 by Pete Keleher.
  49. bibtex.hqx      - BibTeX 1.1.6 by Vince Darley.
  50. excalibur.hqx   - Excalibur 2.3.1 by Rick Zaccone and Robert Gottshall.
  51. makeindex.hqx * - MakeIndex 1.1 by Rick Zaccone.
  52. register.hqx    - Register (to pay the shareware fee).
  53.  
  54. The asterisks indicate the files that have NOT changed since OzTeX 2.1.
  55.  
  56.  
  57. System and memory requirements
  58. ------------------------------
  59.  
  60. OzTeX, OzMF and OzMP run on all Macintosh models from a Mac Plus to
  61. a Power Mac (in native mode) and under all System versions from 4.1 up.
  62. System 7 or later is preferred because OzTeX can then call OzMF to make
  63. missing PK fonts on demand.  A color monitor helps when previewing,
  64. but is not essential.
  65.  
  66. As distributed, the preferred memory sizes for all applications add up to
  67. about 4Mb (or a bit over 5Mb on a Power Mac with virtual memory turned off).
  68. Typically you should only need two of the three applications running at any
  69. given time.  If you are typesetting very large documents, like a book or a
  70. thesis, then you will probably need to double the memory size for OzTeX.
  71. Only Metafont hackers should need to increase the OzMF's memory.
  72.  
  73. A typical OzTeX system uses about 10 to 20Mb of disk space, depending on
  74. the block size of your disk and how many bells and whistles you want.
  75. A minimal OzTeX system could probably squeeze into 5Mb if you only want
  76. to run TeX and print/preview the occasional document (a later section
  77. discusses how to set up such a system).
  78.  
  79.  
  80. How to install OzTeX
  81. --------------------
  82.  
  83. If you already have an older version of OzTeX then you should install this
  84. new version in a new folder to avoid clobbering any of your own config files,
  85. fonts, input files, etc.  After you have the new version up and running you
  86. can merge in your own modifications.
  87.  
  88. Assuming you have enough disk space, carry out these steps:
  89.  
  90. 1. Create a new folder anywhere on your disk and call it anything you like.
  91.    "OzTeX" would be a good choice!
  92.  
  93. 2. Put all the hqx files in the new folder and unpack them.  The easiest
  94.    way to unpack everything is to select all the hqx files and drag them
  95.    onto the icon for StuffIt Expander.  Other programs like Compact Pro
  96.    or UnStuffIt will only convert the hqx files into sea files; just
  97.    double-click on these self-extracting archives to unpack them.
  98.    Delete all hqx/sea files after everything has been unpacked.
  99.  
  100. 3. To check the installation, double-click on the Correct file.  This file
  101.    is a TeachText/SimpleText document containing a picture of a correctly
  102.    installed OzTeX folder.  Make sure your new folder looks the same!
  103.  
  104. That's it.  OzTeX, OzMF and OzMP should now be ready to run.
  105.  
  106.  
  107. How to print the OzTeX User Guide
  108. ---------------------------------
  109.  
  110. 1. Start up OzTeX by double-clicking on the application.  It should load
  111.    the Default configuration file, and then an encoding file.  (If you get
  112.    any warning messages about unknown folders or files then you've made a
  113.    mistake during installation, so go back and check the Correct file.)
  114.  
  115. 2. OzTeX is set up to print on A4 paper.  If your printer uses US Letter
  116.    paper then select "US Letter" from the Config menu.
  117.  
  118. 3. Select "Page Setup..." from the File menu and check that the paper size
  119.    and orientation are correct.
  120.  
  121. 4. OzTeX's Default configuration file is set up for a 300 dpi printer.
  122.    If you are using a StyleWriter (or any 360 dpi printer) then select
  123.    the "StyleWriter" item in the Config menu.  If you have an ImageWriter
  124.    (or any 144 dpi printer) then select the "ImageWriter" item.  There are
  125.    also items for a Linotronic (at 1270 dpi) and a 600 dpi printer.
  126.  
  127. 5. Select "Print DVI..." from the File menu and open ozuser.dvi in the
  128.    LaTeX-docs folder.
  129.  
  130. 6. When the print dialog box appears, select suitable options.
  131.    For example, reverse the page order if your printer stacks pages face up.
  132.    Note that OzTeX is supplied with enough PK fonts to print the User Guide
  133.    on 144/300/360 dpi printers.  If you don't have such a printer (or if you
  134.    don't know), make sure the "Make missing PK fonts" option is checked.
  135.    Finally, click on the Print button.
  136.  
  137. Once the User Guide is printed you might like to read it!
  138.  
  139.  
  140. Important changes
  141. -----------------
  142.  
  143. OzTeX 3.0 is a major new release, so there are many important changes:
  144.  
  145. - WARNING!  If you want to run both 3.0 and an older version of OzTeX then
  146.   beware -- the first time 3.0 starts up it will update the version number
  147.   in OzTeX Prefs (probably stored in your system's Preferences folder) 
  148.   and you won't be able to start up the old version of OzTeX.
  149.   To prevent this happening, the simplest solution is to make a copy of
  150.   the OzTeX Prefs file and put it in the same folder as your old OzTeX.
  151.   Just make sure you do this BEFORE starting up 3.0.  The old OzTeX will then
  152.   use the local OzTeX Prefs, and 3.0 will use OzTeX Prefs in your Preferences
  153.   folder.  There is no need to worry about the Prefs files for OzMF and OzMP.
  154.  
  155. - OzMP is an implementation of John Hobby's MetaPost program for producing
  156.   PostScript pictures using a Metafont-like language.  The OzMP application
  157.   should be kept in the same folder as OzTeX, along with the MetaPost folder.
  158.  
  159. - OzTeX's built-in DVI-to-PostScript translator has been replaced by dvips.
  160.   The OzDVIPS application is no longer necessary.  I've enhanced dvips so
  161.   that it can do all the things done by OzTeX's old translator.
  162.  
  163. - The new version of dvips in OzTeX includes some handy features:
  164.   * Partial downloading of PostScript fonts.
  165.   * Support for HyperTeX \specials.
  166.   * Downloading of PostScript fonts used (but not included) in EPSF files.
  167.  
  168. - The Print DVI dialog boxes have been changed to make it easy to enter
  169.   dvips options via a pop-up menu.
  170.  
  171. - "Use Format in Log" has been removed from the TeX menu.  Too many people
  172.   were getting stuck after creating a log file with the wrong format.
  173.   A better and safer way to force a particular format is to include a line
  174.   like "%&LaTeX" or "%&Plain" at the start of your input file.
  175.  
  176. - The "Fix VFs" items have been removed from the TeX menu.  The previewer
  177.   now handles virtual fonts on the fly, just like dvips.
  178.  
  179. - OzTeX has a new Tools menu.  DVIDVI and DVIcopy (formerly "Fix VFs in DVI")
  180.   have been moved from the TeX menu to the Tools menu.  This menu also has
  181.   the latest versions of Angus Duggan's utilities for manipulating PostScript
  182.   files: PSbook, PSnup, etc.  New items in the Help menu describe each tool.
  183.  
  184. - The File menu has a new "Send foo.ps" item.  The file name shown is the
  185.   most recent output file created by dvips or the PS tools.
  186.  
  187. - OzTeX's low-level PostScript printing code now works under QuickDraw GX.
  188.  
  189. - Major changes have been made to the way OzTeX processes a DVI page.
  190.   Most people won't notice any difference as a result of these changes.
  191.   However, if you relied on the fact that OzTeX printed all the \specials on
  192.   a page first (eg. to overlay text on a grey background) then you might
  193.   have to change the location of some \special commands.
  194.  
  195. - The previewer now supports the HyperTeX \special commands.
  196.   These \specials let you jump to another place in a document by simply
  197.   clicking on a link, such as a reference to a section number.  To see how
  198.   HyperTeX links work, view ozuser.dvi or hyper.dvi in the LaTeX-docs folder.
  199.  
  200. - There are two new items in the View menu: Back Link and Forward Link.
  201.   Their keyboard short cuts are "[" and "]" respectively.  These items make
  202.   it easy to move to previously visited links; they work just like the
  203.   Back/Forward buttons in a Web browser.
  204.  
  205. - The previewer now supports the color \special commands used by dvips and
  206.   generated by LaTeX's color package.  The hyper.tex file in LaTeX-docs shows
  207.   how the color package can be used.  (Note that the color \specials are not
  208.   yet supported for QuickDraw printers; that will have to wait for when I buy
  209.   a color printer!)
  210.  
  211. - The LaTeX-docs folder has a new "LaTeX Short Course" subfolder generously
  212.   donated by George Gratzer.  It contains the source files for Part I of
  213.   George's book "Math into LaTeX -- An Introduction to LaTeX and AMS-LaTeX".
  214.  
  215. - A few changes have been made to the keyboard short cuts recognized by OzTeX
  216.   while previewing a DVI file.  In particular, the old "f" and "l" short cuts
  217.   for first and last page are now "h" (for home) and "e" (for end).  The main
  218.   reason for this change is to allow "f" to be a short cut for Full View.
  219.   All command-key items in the View menu now have matching short cuts.
  220.   See Handy Hints in the Help menu for a complete list.
  221.  
  222. - The roles of a simple click and an Option-Command-click have been reversed.
  223.   A simple click now magnifies the area under the cursor.  This area can now
  224.   be moved around while holding down the mouse button; if the mouse moves
  225.   outside the viewing area then scrolling will occur.  These new features
  226.   are so convenient that I decided most people would prefer access to them
  227.   using a simple click rather than the Option-Command-click contortion.
  228.  
  229. - The View DVI dialog has a new "Dither bitmaps" option which tells OzTeX
  230.   whether or not to dither the bitmaps used for PK fonts and \special images.
  231.   Dithering improves the readability of PK fonts, but it is a bit slower.
  232.   While viewing a page you can press "d" to toggle the dither option.
  233.  
  234. - OzTeX no longer displays a warning dialog when previewing a DVI file that
  235.   includes an EPSF file without a PICT 256 resource.  Instead, OzTeX draws a
  236.   rectangle showing the bounding box, along with the name of the file and the
  237.   message "no PICT" near the \special marker.
  238.  
  239. - Configuration files can use some new parameters:
  240.  
  241.   pstool_output = <filename>
  242.   Sets the default name of the output file created by PSbook, PSnup, etc.
  243.   The Default config file sets the name to out.ps.
  244.  
  245.   missing_picts = <color>
  246.   Specifies the color of the box and message seen when previewing an EPSF
  247.   file with no PICT.  The Default file sets the color to red.
  248.  
  249.   hypertex_links = <color>
  250.   Specifies the color of HyperTeX links.  The Default color is green.  
  251.  
  252. - These parameters are no longer used:
  253.  
  254.   dvips_application
  255.   dvi_to_ps_prolog
  256.   standard_prolog
  257.   global_ps_file
  258.   dvidvi_examples
  259.   conserve_vm
  260.  
  261. - The ps_folders list in the Default config file now includes :DVIPS:Inputs:
  262.   so dvips can locate various files (config.*, psfonts.*, *.enc, *.pro).
  263.  
  264. - The ps_folders list also includes the special entry "$f".  OzTeX replaces
  265.   $f with the path to your system fonts folder so that dvips can locate
  266.   PostScript font files.  The ps_folders lines (along with the corresponding
  267.   warnings) have been removed from the various "Add ... Fonts" config files.
  268.  
  269. - TeX's trie_size parameter can now go up to 65000.  Handy for languages like
  270.   German that can require lots of hyphenation patterns.
  271.  
  272. - Just before running TeX, OzTeX will load <format>.config if it exists in
  273.   the same folder as the input file.  This is handy for people who use both
  274.   LaTeX 2.09 and 2e and need to switch to different input_folders.
  275.  
  276. - All new TEXT files created by OzTeX now have your chosen editor's signature,
  277.   so double-clicking on a new .log/aux/toc file will open it in the editor.
  278.   Note that OzTeX won't change the signature of existing files, so you can
  279.   still double-click on your old .log files to start up OzTeX.  If you want
  280.   to do that after creating a new .log file, just use ResEdit or some other
  281.   utility to change the file's creator signature to "OTEX".
  282.  
  283. - The "Big TeX" config file has been removed.  I decided this was a silly
  284.   approach because if you need to use big formats then you might as well
  285.   use them all the time, and just call them Plain.fmt, LaTeX.fmt, etc.
  286.   The big TeX parameters are now stored in the notes at the end of the
  287.   Default config file, along with new instructions.  The User Guide section
  288.   on building big formats has also been modified.
  289.  
  290. - I've increased a couple of TeX parameters (hash_size and hash_prime) in the
  291.   Default config file and rebuilt all format files.  I've also increased
  292.   OzTeX's preferred memory size by 100K.
  293.  
  294. - The new REVTeX subfolder in TeX-inputs contains the latest REVTeX 3.1
  295.   release (including the revtex.cls patch for LaTeX2e).
  296.  
  297. - The AMS folder has been updated with the latest versions of AMS-TeX,
  298.   AMS-LaTeX and AMSFonts.
  299.  
  300. - The TeX-inputs folder has been updated with the Dec 1996 release of LaTeX.
  301.   Note that I've removed oztex.def from the Graphics subfolder; OzTeX now
  302.   uses dvips.def.
  303.  
  304. - New versions of AlphaLite, BibTeX and Excalibur are included.
  305.  
  306. For more details about these and other changes, select "Changes to OzTeX 2.1"
  307. from OzTeX's Help menu.
  308.  
  309.  
  310. Choosing an editor
  311. ------------------
  312.  
  313. OzTeX does not contain an integrated text editor.  Instead, Pete Keleher's
  314. AlphaLite program is supplied.  You might prefer to use another editor.
  315. Nearly all the text files distributed with OzTeX are created by MPW (that's
  316. the editor I prefer to use).  Note that AlphaLite lets you change the creator
  317. of all text files in a selected folder.
  318.  
  319. If you are using System 7 or later then one of the first things you should do
  320. after starting up OzTeX for the very first time is to select "Choose Editor"
  321. from the Edit menu.  Use the standard file dialog to select the application
  322. you'll be using to edit TeX/LaTeX input files.  If the application can
  323. receive Apple events then OzTeX will remember its name and location
  324. for later use.
  325.  
  326.  
  327. A minimal OzTeX system
  328. ----------------------
  329.  
  330. You might be running short of space on your disk, so let's consider the
  331. bare essentials needed for a working OzTeX system (before deleting any
  332. files it would be a good idea to save a backup copy):
  333.  
  334. - Use programs like Strip68K/StripPPC to remove unwanted 68000/PowerPC
  335.   code from all applications.
  336. - Delete the AlphaLite folder if you use a different text editor.
  337. - Delete the Excalibur folder if you don't need a spelling checker.
  338. - Delete the MakeIndex folder if you don't need to create an index.
  339. - Delete the BibTeX folder if you don't need to create a bibliography.
  340. - Delete OzMF and the Metafont folder if you have a full set of TFM and PK
  341.   files, and you won't be needing any of the font related tools in OzMF.
  342. - If you don't use LaTeX, delete the LaTeX, Graphics, PSNFSS, Tools and
  343.   HyperRef subfolders from TeX-inputs.  Also delete :TeX-formats:LaTeX.fmt.
  344. - If you don't use AMS-TeX or AMS-LaTeX, delete the AMS folder and AMSTeX.fmt.
  345.   To avoid warning messages when OzTeX/OzMF start up, you also need to edit
  346.   their Default files and remove all paths containing "AMS".
  347. - Delete the REVTeX subfolder in TeX-inputs if you aren't a physicist.
  348. - If you don't have access to a PostScript printer then delete the DVIPS
  349.   folder, the OzMP application, and the MetaPost folder.
  350. - If you won't be using PostScript fonts then delete all files in the
  351.   VF-files folder and delete the PS subfolder in TeX-fonts.
  352. - TeX-docs and LaTeX-docs contain important documentation and example files,
  353.   so don't delete any files from these folders until you've looked at them.
  354. - Delete everything in the Help-files folder if you know it all by heart.
  355. - Delete the Register folder after paying the shareware fee(s). :-)
  356.  
  357. Happy OzTeXing!
  358.